package com.zenithmind.task.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.common.result.PageResult;
import com.zenithmind.task.pojo.entity.TaskCategory;
import com.zenithmind.task.pojo.query.TaskCategoryQuery;
import com.zenithmind.task.pojo.vo.TaskCategoryVO;

import java.util.List;

/**
 * 任务分类服务接口
 * 
 * @author ZenithMind Team
 * @since 2025-01-09
 */
public interface TaskCategoryService extends IService<TaskCategory> {

    /**
     * 分页查询分类列表
     *
     * @param query 分类查询条件
     * @return 分类分页列表
     */
    PageResult<TaskCategoryVO> getCategoryPage(TaskCategoryQuery query);

    /**
     * 查询分类树
     * 
     * @param userId 当前用户ID
     * @return 分类树
     */
    List<TaskCategoryVO> getCategoryTree(String userId);

    /**
     * 根据ID查询分类详情
     * 
     * @param id 分类ID
     * @param userId 当前用户ID
     * @return 分类详情
     */
    TaskCategoryVO getCategoryById(String id, String userId);

    /**
     * 创建分类
     * 
     * @param category 分类信息
     * @param userId 创建者ID
     * @return 创建结果
     */
    Boolean createCategory(TaskCategory category, String userId);

    /**
     * 更新分类
     * 
     * @param category 分类信息
     * @param userId 操作者ID
     * @return 更新结果
     */
    Boolean updateCategory(TaskCategory category, String userId);

    /**
     * 删除分类
     * 
     * @param id 分类ID
     * @param userId 操作者ID
     * @return 删除结果
     */
    Boolean deleteCategory(String id, String userId);

    /**
     * 移动分类
     * 
     * @param id 分类ID
     * @param newParentId 新父分类ID
     * @param userId 操作者ID
     * @return 移动结果
     */
    Boolean moveCategory(String id, String newParentId, String userId);

    /**
     * 查询用户可见的分类列表
     * 
     * @param userId 用户ID
     * @return 分类列表
     */
    List<TaskCategoryVO> getUserCategories(String userId);

    /**
     * 查询系统默认分类
     * 
     * @return 系统分类列表
     */
    List<TaskCategoryVO> getSystemCategories();

    /**
     * 更新分类任务数量
     * 
     * @param categoryId 分类ID
     * @return 更新结果
     */
    Boolean updateCategoryTaskCount(String categoryId);
}
